Skip to content

feat: add Perseus Vault — persistent agent memory engine (FTS5 hybrid, no embeddings)#9

Open
tcconnally wants to merge 2 commits into
ProsusAI:mainfrom
tcconnally:add-mimir-system
Open

feat: add Perseus Vault — persistent agent memory engine (FTS5 hybrid, no embeddings)#9
tcconnally wants to merge 2 commits into
ProsusAI:mainfrom
tcconnally:add-mimir-system

Conversation

@tcconnally

@tcconnally tcconnally commented Jun 22, 2026

Copy link
Copy Markdown

Perseus Vault: Persistent Agent Memory Engine

Perseus Vault (formerly "Mimir"/"Mneme") is a persistent agent memory engine with structured entities and FTS5 hybrid search. It achieves 72% accuracy on LongMemEval oracle split — beating FullContext by 26 percentage points — while using no embedding API.

Key Features

  • Structured entity storage with tags, categories, decay, links, verification
  • FTS5 hybrid search — semantic keyword matching without embeddings
  • HTTP/SSE MCP transport — connects to a running perseus-vault serve instance
  • Zero embedding cost — all retrieval is local SQLite FTS5
  • Proactive recall hooks (recall_when) for agent-driven memory

LongMemEval Results (oracle split, 50 temporal reasoning questions)

System Accuracy F1 Tokens
Perseus Vault 0.720 0.201 277,824
FullContext 0.460 0.285 381,439

LLM: gemma-4-26b-a4b-it via OpenRouter

Setup

# Start Perseus Vault
perseus-vault serve --db /tmp/perseus_vault_bench.db --transport sse --port 8766 &

# Run benchmark
uv run python scripts/run_full_benchmark.py \
  --benchmark longmemeval --split oracle \
  --systems perseus_vault --num-samples 50

Links

(Renamed from "Mimir": the memory engine this benchmark targets was renamed to Perseus Vault. The system module is now perseus_vault — invoke with --systems perseus_vault.)

Mimir is a persistent agent memory engine with structured entities
and FTS5 hybrid search. No embedding API required.

LongMemEval oracle split (gemma-4-26b):
- Accuracy: 0.720 (vs FullContext 0.460)
- F1: 0.201
- Tokens: 277,824 (27% fewer than FullContext)

Uses HTTP/SSE MCP transport to connect to a running Mimir server.
@tcconnally tcconnally changed the title feat: add Mimir — persistent agent memory engine (FTS5 hybrid, no embeddings) feat: add Perseus Vault — persistent agent memory engine (FTS5 hybrid, no embeddings) Jul 8, 2026
@tcconnally

Copy link
Copy Markdown
Author

Heads up — I've updated this PR. The memory engine was renamed from Mimir to Perseus Vault, so the system module is now src/agents_memory/systems/perseus_vault.py (class PerseusVaultClient, invoked with --systems perseus_vault), and the canonical MCP tool names (perseus_vault_remember / perseus_vault_recall) and repo link are updated. The benchmark logic and results are unchanged. Thanks!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant